package com.ruoyi.system.mapper;

import java.util.List;
import com.ruoyi.system.domain.SuperCouponReceive;
import org.apache.ibatis.annotations.Param;

/**
 * 用户优惠券记录:记录优惠券发放/领取记录
 * Mapper接口
 * 
 * @author ruoyi
 * @date 2025-08-13
 */
public interface SuperCouponReceiveMapper 
{
    /**
     * 查询用户优惠券记录:记录优惠券发放/领取记录
     * @param id 主键
     * @return 记录
     */
    public SuperCouponReceive selectSuperCouponReceiveById(Long id);

    /**
     * 查询用户优惠券记录:记录优惠券发放/领取记录列表
     * @param superCouponReceive 查询条件
     * @return 集合
     */
    public List<SuperCouponReceive> selectSuperCouponReceiveList(SuperCouponReceive superCouponReceive);

    /**
     * 统计用户可用优惠券数量（未使用、未删除、优惠券未删除）
     * @param userId 用户ID
     * @return 数量
     */
    public int countUserAvailableCoupons(@Param("userId") Long userId);

    /**
     * 新增用户优惠券记录
     * @param superCouponReceive 记录
     * @return 结果
     */
    public int insertSuperCouponReceive(SuperCouponReceive superCouponReceive);

    /**
     * 修改用户优惠券记录
     * @param superCouponReceive 记录
     * @return 结果
     */
    public int updateSuperCouponReceive(SuperCouponReceive superCouponReceive);

    /**
     * 删除用户优惠券记录
     * @param id 主键
     * @return 结果
     */
    public int deleteSuperCouponReceiveById(Long id);

    /**
     * 批量删除用户优惠券记录
     * @param ids 主键集合
     * @return 结果
     */
    public int deleteSuperCouponReceiveByIds(Long[] ids);
}
